QuickTime 3 Reference

Supplying Parameter Description Information

Your effect must supply information to its client software that describes the parameters that the effect takes. Each parameter is described using a specific format, which is described in "The Parameter Description Format" .

The easiest way to supply this information back to the client software is to add an `atms' resource to your component. The `atms' resource contains the parameter descriptions in the required format. You can retrieve the resource by calling the GetComponentResource function, as shown in Listing 20-14 .

Listing 14 An implementation of the GetParameterListHandle function



 
pascal ComponentResult GetParameterListHandle(EffectGlobals*glob,

                                 Handle         *theHandle)

{

    OSErr   err = noErr;



    err = GetComponentResource((Component) glob->self,

                        OSTypeConst('atms'),

                        kEffectatmsRes,

                        theHandle);



    return err;

}

By implementing the GetParameterListHandle function in this way, you reduce the problem to supplying an appropriate `atms' resource with your component.

Adding an `atms' Resource to your Component

Tweening Parameters